Skip to content

[Support Feedback] Improve IUAM, DDoS triage, and origin protection docs (DDoS Protection)#28994

Open
dmmulroy wants to merge 4 commits intocloudflare:productionfrom
dmmulroy:support-macros/ddos-protection
Open

[Support Feedback] Improve IUAM, DDoS triage, and origin protection docs (DDoS Protection)#28994
dmmulroy wants to merge 4 commits intocloudflare:productionfrom
dmmulroy:support-macros/ddos-protection

Conversation

@dmmulroy
Copy link

Summary

Expands DDoS protection documentation for common support topics, based on an audit of active support macros.

Changes

  • I'm Under Attack Mode (IUAM): Document configuration options, expected visitor experience, and when to use vs. alternatives
  • DDoS response triage: Add a checklist for customers experiencing an active attack (what to collect, what to configure, when to escalate)
  • Origin protection: Explain why Cloudflare IPs appear in origin server logs and how to restore original visitor IPs

Context

These changes are driven by recurring support cases. If you want to see the underlying support data (macro frequency, case volume by topic), reach out to @dmmulroy internally.

@dmmulroy dmmulroy force-pushed the support-macros/ddos-protection branch from c833b49 to 57368c3 Compare March 17, 2026 15:28

### Selectively disable for specific areas

If you have enabled Under Attack mode site-wide but it breaks certain parts of your site (for example, API endpoints or areas that serve non-browser traffic), use a [configuration rule](/rules/configuration-rules/) to set the security level to a lower value for those paths.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@dmmulroy

This statement ...to set the security level to a lower value for those paths. is incorrect.

Customers can no longer able to change levels (low, medium, etc..).

I'd suggest changing it to ...to disable I’m Under Attack for those paths.

- **Under Attack mode applies challenges at Cloudflare's edge.** Challenge outcomes are recorded in [Cloudflare security analytics](/waf/analytics/security-events/). Requests reach your origin only after a challenge is solved, via a valid `cf_clearance` cookie, or when traffic is excluded from Under Attack mode through configuration rules.
- **Non-browser traffic will be blocked.** Under Attack mode requires JavaScript execution, so API clients, mobile apps, and automated integrations will fail the challenge. Use configuration rules or WAF custom rules to exclude these paths or traffic types.
- **Disable when the attack subsides.** Under Attack mode is designed as a temporary measure. Once attack traffic returns to normal, turn it off to avoid unnecessarily challenging legitimate visitors.
- **Consider customizing the challenge page.** You can brand the interstitial page shown to visitors during the challenge. Go to **Configurations** > **Custom Pages** > **Managed Challenge / I'm Under Attack Mode** to configure a custom page.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@dmmulroy

Let's change: Go to **Configurations** > **Custom Pages**

To: Go to **Configurations** > **Error Pages**

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants